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What’s in this 
Primer? 


This version of the HST Archive Primer provides the basic information a 
user needs to know to access the HST archive via StarView, the new user 
interface to the archive. Using StarView, users can search for observations of 
interest, find calibration reference files and retrieve data from the archive. 
Both the terminal version of StarView and the X-windows version feature a 
name resolver which simplifies searches of the HST archive based on target 
name. In addition, the X-windows version of StarView allows preview of all 
public HST data; compressed versions of public images are displayed via 
SAOIMAGE, while spectra are plotted using the public plotting package, 
XMGR. Finally, the version of StarView described here features screens 
designed for observers preparing Cycle 5 HST proposals. 

This manual is organized as follows; 

• Chapter 1, “Introduction to the HST Archive,” provides a basic intro- 
duction to the archive, describing the data in the archive, the archive 
system and interface, and the support provided by STScI for those 
using the HST archive. 

• Chapter 2, “Getting Started on the Archive System,” describes how 
users access the HST archive through the two archive host computers, 
STDATA and STDATU. 

• Chapter 3, “StarView Tutorial,” provides two tutorial sessions. The first 
shows you how to use StarView to select observations of interest, 
retrieve that data to the archive host computers and transfer it via FTP 
to your home computer. The second describes the use of the calibration 
reference screens in StarView which allow you to retrieve the best 
available calibration reference files with which to recalibrate your HST 
data. 
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Chapter 4, “Duplication Checking,” provides a tutorial ses- 
sion using the duplication Check> and <Proposal 
Abstracts> screens for the preparation of Cycle 5 HST 
observing proposals. You can use the duplication Check> 
screen to search for potential conflicts between previ- 
ously-approved HST observations (both planned and exe- 
cuted) and those that you are proposing. Archival 
researchers may also find this screen useful for preparing 
archival proposals. 




Introduction to the 
HST Archive 


In This Chapter- 

Data in the Archive / 1 

Publication of HST Archival Research Results / 2 

Other Archives Containing HST Data / 3 

HST Archive Systems / 3 

StarView: A New User Interface / 4 

Retrieving Data / 4 

This Primer/ 5 

User Support Sen/ices / 5 




chival research is an important component of the Hubble Space 
Telescope (HST) program. Calls for proposals for funded archival research 
(by U.S. investigators) occur regularly with the HST Call for Proposals. 
Requests for archival data and visits to the Space Telescope Science Institute 
(STScI) for archival research projects that do not involve funding are 
considered year-round. 


Data in the Archive 

The HST archive contains science data from all completed HST 
observations and calibration files, such as flat fields, which are used to reduce 
these data. As of April 1994, nearly 6,000 different astronomical targets had 
been observed. 1 In addition to all the standard files sent to observers and all 
the calibration reference files, the archive contains engineering files that may 
be useful for diagnosing some questions about observations. The archive also 
contains the raw science data stream from HST, which is not generally useful 


1. All data for observations obtained prior to March, 1992 have been 
reprocessed using updated calibration files and software so that both the 
data itself and the keyword information are of higher quality than the data 
originally sent to observers. 


1 
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to astronomers, but can be used at STScI to regenerate the Space 
Telescope Science Data Analysis System (STSDAS) files 
containing raw science data. As data are archived, information 
about observations and the sources being observed is extracted 
from the data files and stored in an online catalog. 

HST data become available to the astronomical community 
upon the expiration of a proprietary period. Most general observer 
(GO) and guaranteed time observer (GTO) observations have 
proprietary periods of a year, but some observations have shorter or 
longer proprietary periods. Nearly all calibration observations are 
made public immediately upon receipt. The archive catalog 
contains information about all observations that have been made 
with HST. However, only data that are public can be retrieved from 
the HST archive. 


Publication of HST Archival Research Results 

The results of investigations with HST archive data are 
generally published in the scientific literature. All publications 
based on these data must carry the following footnote: 

"Based on observations made with the NASA/ESA Hubble 
Space Telescope, obtained from the data archive at the Space 
Telescope Science Institute. STScI is operated by the 
Association of Universities for Research in Astronomy, Inc. 
under NASA contract NAS 5-26555." 

If the archival research was supported by a grant from STScI, 
the publication should also carry the following acknowledgment at 
the end of the text: 

“Support for this work was provided by NASA through grant 

number from the Space Telescope Science 

Institute, which is operated by AURA, Inc., under NASA 
contract NAS 5-26555." 

One preprint or reprint of each refereed publication based on 
HST archival research must be sent to the following address: 

Librarian 

Space Telescope Science Institute 
3700 San Martin Drive 
Baltimore, MD 21218 USA 
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Other Archives Containing HST Data 

Copies of the HST data and the archive catalog are maintained at the 
Space Telescope European Coordinating Facility (ST-ECF) in Garching, 
Germany and at the Canadian Astronomy Data Centre (CADC) in Victoria, 
Canada. There is a significant amount of collaboration and coordination 
between the ST-ECF and the CADC to assure that the data and the basic 
services we provide are similar. However, the archives are not identical. 
Therefore, European and Canadian astronomers should contact the ST-ECF or 
CADC for information about using their archive systems. 


HST Archive Systems 

The archive system in use at STScI today— the Data Management Facility 
(DMF) — was developed by STScI with help from ST-ECF and the CADC. 
Since launch, about one terabyte of data has been archived onto two-gigabyte 
optical disks. Data are currently being archived at a rate of about one gigabyte 
per day. In the past, users have worked with DMF using an interface known as 
STARCAT, which was developed by the ST-ECF, with support from the 
CADC and STScI. Currently, 200 to 400 non-STScI astronomers access the 
DMF archive catalog and retrieve 3 to 5 gigabytes of HST data each month. 
However, DMF was always intended as a prototype for a permanent archive 
system. 

The permanent archive system — the Space Telescope Data Archive and 
Distribution Service (ST-DADS)— was delivered by Loral Aerosys to STScI 
in September 1993. A combined STScI and Loral team is currently 
completing the software needed to allow us to replace DMF. The transition 
from DMF to ST-DADS is underway, and we are now archiving data to DMF 
and ST-DADS in parallel. The new system should improve archive 
performance significantly. For example, when the transition is complete, we 
will be able to maintain nearly five years, instead of nine months, of HST data 
online in the ST-DADS optical disk jukeboxes. In addition, the data will be 
stored almost entirely in FITS formats instead of the VAX-specific GEIS 
format used by DMF. 

We hope to finish the transition from DMF to ST-DADS in the autumn of 
1994. However, users will continue to have access to DMF until all the major 
capabilities of DMF have been duplicated in ST-DADS and the data stored in 
DMF have been copied to ST-DADS. We expect to hide most of the hardware 
changes from users. However, during the transition, it will be especially 
important to read the news (type readnews) and information when you log 
in to the archive host machines. 
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StarView: A New User Interface 

As part of the ST-DADS effort, STScI developed the StarView 
interface to the HST archive. Using StarView, you will be able to 
ask common questions about the data in the archive, determine 
whether the data are public, and retrieve the data that you want. 
StarView can be used from any standard terminal, or from an 
X-windows display system. The X-windows version of StarView 
not only provides a very intuitive means of accessing the HST 
Archive Catalog, but also allows you to preview a compressed 
version of the public data in the archives, which may help you 
determine whether the data are suited to your puiposes. StarView 
can be run by logging into one of the guest accounts on the archive 
host machines, stdata.stsci.edu and stdatu.stsci.edu, 
or, if your site has installed the distributed client-server version of 
StarView, you may be able to run the X-Windows version of 
StarView locally. (More details on the client-server software can be 
found in “Distributed StarView” on page 22). 


Retrieving Data 


If you decide that you want to retrieve data, we need to establish 
a computer account for you. For us to do this, you will have to 
register as an archive user (see “Registering as a User” on 
page 14). Once you have an account, you will be able to retrieve 
public data by marking particular datasets and choosing where you 
want the data put — either on magnetic disk for you to retrieve 
electronically or on a magnetic tape for us to send to you. 

To make sure that we can provide a reasonable level of service 
for all those who want to use the archive, we have had to establish 
quotas on the amount of data that you can retrieve. For retrievals to 
the archive host machines, the current size limit is 500 megabytes. 
If you want to retrieve larger amounts of data, you should ask for 
the data to be written to Exabyte or 9-track tape. We have also 
established cumulative quotas on the total amount of data any one 
person can retrieve. For archive researchers, the quota is currently 
set to 20 gigabytes. If you exceed your quota, contact the archive 
hotseat (see below) and we will (within limits) increase the quota 
you are allocated. Funded HST archive researchers can, of course, 
expect to have large enough quotas to retrieve all of the data 
specified in their archival research program. 

Most people will retrieve data from the archive using StarView. 
However, it is also possible to ask for data by filling out a paper 
Request for Archival Data form. A copy of the form is provided in 
the appendix. You can find electronic versions of forms on the 
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archive host machines or request them from the archive hotseat (see User 
Support Services” on page 5). 


This Primer 


The HST Archive Primer provides a short introduction to the HST Data 
Archives and to the use of the archive interface, StarView. A more detailed 
description of the archives can be found in chapters 5 through 10 of the HST 
Archive Manual. At present, however, the manual only describes the generic 
terminal version of StarView. The manual will be updated in the autumn of 
1994 when the conversion of the archives from DMF to DADS is complete. 
Until then we again recommend that you occasionally log into the archive 
host machines and use the readnews command to check on new 
developments. 


User Support Services 

The Data Systems Operations Branch (DSOB) at STScI is committed to 
providing outstanding support to archive researchers. We provide assistance 
and advice on methods and strategies for finding information in the archives 
and provide a hotseat staff for researchers who have specific problems or 
questions about using the archive. Archive researchers who need extensive 
advice on search strategies or help analyzing their astronomical data can visit 
STScI. 


Support for Archival Research 

The Data Systems Operations Branch (DSOB) of STScI is responsible for 
the management, scientific and technical oversight, and operation of the HST 
archive. DSOB staff also support astronomers who wish to use public data 
from the HST archive for their own research. To provide assistance for 
archive researchers, the DSOB staff includes archive specialists (with 
bachelor or masters level degrees in physics or astronomy) and archive 
scientists (Ph.D astronomers). The support provided by DSOB includes: 

• Answering specific questions about data in the archives and methods 
for retrieving that data. 

• Providing advice on strategies for searching the archives. 

• Responding to problems identified by users. 

• Setting up accounts for users who wish to retrieve data. 

• Writing data tapes for users. 
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• Providing support for users who visit STScI. 

DSOB staff will not normally do an astronomer’s archive 
search, generate requests for data, or reanalyze data from the 
archive. DSOB staff will provide assistance and documentation so 
that archive researchers can perform these tasks. 


Archive Hotseat 

You can obtain help or answers to any questions that you may 
have about the HST archive by sending e-mail to 
archive@stsci.edu, or by phoning (410) 338-4547 
Monday through Friday, 9 a.m. to 5 p.m. Eastern time. 

The hotseat staff will respond to questions concerning the 
StarView user interface, the archive and archive databases, and 
data tapes provided by STScI. Hotseat personnel establish the 
accounts needed to retrieve data from the archive. The hotseat staff 
will also provide advice concerning basic strategies, and will 
investigate and document all problem reports. The archive hotseat 
people may not always know how to solve a problem, but they are 
responsible for finding out who does know the answer and for 
continuing to work with you until the problem is resolved. All 
initial communication from the user community to the 
archive — both inside and outside of STScI — should be directed to 
the archive hotseat. 


Visits 

Archive researchers who need extensive advice on search 
strategies or help analyzing their archival data should visit STScI. 
To make sure that DSOB is able to provide the help needed during 
a visit and to set up the appropriate computer accounts, archive 
visits must be approved by the DSOB branch chief at least two 
weeks in advance. After a visit is approved, an archive specialist 
and an archive scientist will be assigned for the visit. Often you 
will discuss your visit with the archive scientist or archive 
specialist (or both) beforehand. After you arrive, you will meet also 
with the archive scientist to discuss your needs at STScI. The 
archive scientists will be available throughout your visit, up to 
several hours a day, to help you resolve problems. Most of the 
support, however, will be provided by an archive specialist, who 
will be available as needed throughout the visit. 

To arrange a visit, contact the archive hotseat. The archive 
hotseat will e-mail you an editable Archive Research Visit Request 
form, asking for a brief description of the goals of your visit, the 
kind of support you think you need, and a preliminary list of the 
datasets involved. (A copy of the form is provided in the appendix, 
and a PostScript version of the form is maintained on the archive 
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host machines.) Once the archive hotseat has the completed form, we will 
contact you to work out the details of your visit. The number and duration of 
visits is limited by the staff that we have available. If a conflict arises, funded 
researchers will have priority over those who are unfunded. For most 
researchers, three to five days is sufficient time to carry out the portions of a 
project that can be done more efficiently here at STScI. 


Questions and Comments 

We welcome your comments and questions about the archive in general 
and about StarView and this primer manual in particular. As discussed above, 
communication to us regarding all aspects of the archive should normally be 
directed to the archive hotseat (e-mail: archive@stsci . edu, or phone 
(410) 338-4547). This will allow DSOB staff to respond to your requests even 
when individual members of the group are away. If you feel your needs are 
not being adequately addressed through the hotseat however, please contact 
the DSOB Branch Chief, Knox Long (send e-mail to long@stsci.edu 
or phone (410) 338-4826). 
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Getting Started On 
the Archive System 


In This Chapter... 

Logging In and Out / 10 

What You Can Do on the Archive Host Computers / 12 

Available Commands/ 12 

Guest Users / 14 

Registering as a User/ 14 

Using StarView/ 15 

Getting Your Data / 15 

Converting File Formats / 16 

Using FTP / 17 

Documentation on the Telescope, Instruments, and Data / 18 
Using STSDAS to Analyze Your Data/ 20 
Reading Text Files in the Documents Directory/ 20 
Target Cross-Correlation Program/ 22 
Distributed StarView / 22 


T_Jsers from outside STScI can access the Hubble Space Telescope 
(HST) archive through one of the archive host workstations that are 
maintained at the Space Telescope Science Institute (STScI) specifically for 
use by archival researchers. There arc two such workstations: STDATA (a 
VAX running the VMS operating system) and STDATU (a Sun workstation 
running the Unix operating system). We refer to these workstations as the 
archive host computers. Users at STScI can access the HST archive directly 
by running StarView on STScI computers. The two archive host machines are 
intended for users accessing the archive from remote sites. 1 
A typical archive session consists of the following steps: 

1 . Logging into one of the archive host computers 

2. Reading the archive news 


1 . If you are running distributed StarView (page 22), you will not need to log in to 
the archive host computers to run StarView, but you may want to log into them 
occasionally to read the archive news. 


9 
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3. Using StarView (the user interface to the HST Archive) to 
examine the HST catalog and to mark data for retrieval 

4. Getting your data and converting it to a proper format 

5. Logging out of the host computer 

6. Transferring your data back to your home institution’s com- 
puter via FTP 

After this, you can analyze your data on your home computer. 


Logging In and Out 

This section explains how to use TELNET to log into and out of 
STDATA or STDATU. 


Logging In 

Use TELNET to log into STDATA or STDATU. 2 

• To use the VMS host, STDATA, type: 
telnet stdata.stsci.edu 

or 

telnet 130.167.1.135 

• To use the Unix host, STDATU, type: 
telnet stdatu.stsci.edu 

or 

telnet 130.167.1.148 


You can log in from one of the following terminal types or from a 
window emulating one of them: xterm, VT100, Sun (shelltool, 
cmdtool), DEC (VT200, VT300, DECterm, dxterm), or ANSI 
(generic). 


You will be prompted for your user name and password. 
First-time and non-registered users log in to the guest account 
using the user name guest and the password archive. 
Registered HST archive users should log in with their own user 
name and password. The guest account will give you complete 


2. If you are logging in from a Unix machine to STDATU, you can 
use the rlogin command rather than telnet; rlogin transfers ter- 
minal information to the remote host 
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access to the HST catalog. To retrieve data files, you must be a registered user 
(see page 14). 

After you log in, your archive session will continue from your own 
individual work area on the archive host computer’s magnetic disk. Guest 
users share the guest work area. To return to this directory at any point, type 
home from the command line. The size of your work area is limited to 1 
megabyte. Your work area allows you to maintain user-specific files and to 
save files created during a StarView session. It is not intended and is not large 
enough to serve as a repository for HST data. 


Logging Out 

You can exit from StarView, the archive user interface, at any time by 
pressing fControil - H^T Your session will then return to the host system. Exit 
the host system by typing logout. 


Reading the Archive News 

As you log into STDATA or STDATU, you should read the login message, 
which contains important information about the current status of the archive. 
Then, you may want to read the archive news, which provides more 
information about current archive-related topics, including updates on new 
capabilities. To read the news type: 

$ readnews 

You can also e-mail a copy of any of the articles displayed by readnews 
back to your home computer, after reading the article. Figure 2.1 shows a 
sample of reading news. 


xterm 

stdatu.stsci.edu2Z readnews 
Archive News 

1 Calibration Screens 

2 Canned C ow a rds 

3 Early Release Observations 

4 FITS and GEIS 

5 HST DataHandbook 

6 Introduction 

7 Key Project Data 

8 NEW Stuff 

9 StarView 

10 Using STEIS 

11 info 

l Qioose a topic by number, ? to see list, or g to <»jit: | 


Type a number and press (Return! 
to display news Item 


r fg| xterm 

The HST Data Archive is pleased to announce the availability of 
XSTARVIEW 


Starview is the user interface to the Hubble Data Archives. This 
program allows you to easily browse through the HST A-chives and 
retrieve public HST data. Many of you will have already used the CRT 
version of this program. He are now pleased to amorce an Xll-based 
version of starview. Xstarview possess all of the features of its 
CRT-based predece s sor, including the SIMBAD nam e r eso lver, but, in 
addition, allows the user to preview compressed images of HST data. 
U se rs who do not have access to an X-display scr een can continue to use 
the CRT-based version of starview. 

New users have generally ford xstarview to be intuitive, and we hope 
that you too will find it easy to use. Xstarview contains help 
screens, so if you have used the archives before, you may Just want to 
stwt up xstarview immediately and learn by doing. A cookbook -style 
introduction to using the Hubble Archives with starview (both X and 
CRT) can be found in Appendix A of the new HST Data Handbook. A paper 
copy of the Handbook is being sent to all HST Pi's, and is available 

L Choose a number, ? to see list, m to mall article 9, or g to quit: D 


Figure 2.1 : Using the readnews Command 
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What You Can Do on the Archive Host Computers 

There are several things that you can do on the archive host 
computers after you have logged in. Most users will want to run 
StarView, the user interface to the HST archive (see the StarView 
tutorial on page 26). Through StarView you can: 

• View the contents of the HST catalog and select observa- 
tions of interest. 

• Preview public HST data for a quick look. 

• Select calibration reference files to recalibrate HST data 

• Retrieve data from the archive. 

• Perform duplicate checking for the preparation of Cycle 5 
HST proposals. 

There are several other services available on the hsot 
computers. For example, you can: 

• Execute many, though not all, of the normal system com- 
mands (VMS or Unix). 

• Access different kinds of text files: 

- Read the archive news (see above). 

- Get copies of text files, including Postscript versions of 
this primer. 

- Examine the Archived Exposures Catalog (AEC) or the 
Planned and Archived Exposure Catalog (PAEC). 

• Register as an HST archive user so that you can retrieve 
public HST data. 

• Run standalone software tools: 

- To convert data files to various formats (e.g., to Unix or 
FITS format). 

- To run a cross-correlation between the AEC and your own 
list of targets. 


Available Commands 

Your account on the archive host computer allows you to use 
many VMS or Unix commands. In addition, a number of special 
commands (see Table 2.1) let you maneuver easily through the 
directory structure, set up default specifications, obtain information 
about the archive, and manipulate files. 
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Type commands to display a listing of all available commands. 


Command 

Purpose 

capacity 

Check the staging disk capacity 

cd directory 

Change directory, equivalent to VMS command SET DEFAULT 
[ .directory) 

change_editor 

Change the default editor 

commands 

Display a list of available commands 

data 

Change the default directory to the dmf_stage data disk 

dir 

List the files in the current directory 

docs 

Change the default directory to the DOCUMENTS directory 

files 

Write a listing of the directory contents to a file 

home 

Return to your home directory 

more filename 

Display file contents one page at a time 

public 

Change the default directory to the public data directory 

readnews 

Read the HST archive news 

register 

Register as an HST archive user and get your own account 

starview 

Start terminal version of StarView to access HST archive 

stwf its 

Convert an HST data file to FITS format 

sun2vax 

Convert Sun (Unix) format GEIS file to VAX format 

tconvert 

Convert VAX -format table to Unix format 

vax2sun 

Convert VAX -format GEIS file to Sun (Unix) format 

versions 

List the current versions of the archive user documents 

vtlOO 

Set the terminal type to VT100 

xstarview 

Start X -Windows version of StarView to access HST archives 


Table 2.1 : Commands Available on Archive Host Computers 

The default editor for users on STDATA is EDT, for users on STDATU it 
is vi. If you wish to change your default editor, for use on the command line 
and for use whenever StarView itself invokes an editor, use the 
change_editor command. 
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Guest Users 


When you log in as a guest, you will first be asked to choose an 
editor for this session. Then a subdirectory will be created for you 
under the guest directory. The home command will return you 
to that directory. You should note the name of the directory that is 
created for you, in case you wish to use FTP to transfer files you 
create in a StarView session to your home computer (see 17). The 
name of the subdirectory is derived from the name of the computer 
(node) from which you log into STDATA or STDATU (using 
TELNET). You may occasionally find yourself in a directory 
originally created for another user who logged in from a 
similarly-named computer. In that case, we suggest you create a 
subdirectory within that directory and move there before you run 
StarView. For example, on STDATU you could type: 

% mkdir oort 
% cd oort 

On STDATA, you could type: 

$ create/dir [.oort] 

$ cd oort 

These directories are not permanent and will be removed after 
two days. 


Registering as a User 


A guest user has full access to the HST catalog. A guest user 
using xstarview can also preview public HST data, but only 
registered users can retrieve HST data. To register as an HST 
Archive user, you must complete an archive registration form. You 
can register at any time from the command line of the archive host 
simply by typing register . 

This command will put you in your default editor and bring up 
the electronic HST Archive Account Registration form. Type in the 
necessary information and exit the editor. You can exit the editor 
by: 


Pressing 

EDT 


SEE 


\U2 and then typing exit if you are in 


Pressing IConfrofl -HH fcontrojl fcl if you are in emacs 


Pressing [Escl and then typing : wq if you are in vi 


When you exit the editor, the form is submitted as an e-mail 
message to the archive hotseat. A copy of the registration form is 
included in Appendix A. A PostScript version of the form is 
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maintained in the forms subdirectory of the documents directory on the 
archive host. You can also obtain a copy of the form by sending e-mail to 
archive@stsci.edu. 

You will be notified by e-mail of your registration as an archive user 
within two working days of the time when your request is received. As a 
registered user, you will be able to retrieve public HST data through StarView. 
You will be allocated disk space on the archive computer to allow retrieval 
and limited manipulation of non-proprietary data. Your account on the archive 
host computer is set up with limited access to STScI software and is not for 
general-purpose computing. 


Using StarView 

StarView is the user interface that provides you with access to the HST 
catalog and data archive. StarView is available in two forms: 

• An X-Windows based version (xstarview) 

• A terminal version for basic terminals such as VTlOOs 

The X version of StarView has some capabilities, such as image and 
spectrum preview, which are not available in the terminal version. It also has 
the advantage that all features are invoked simply by using the mouse. 
However, the generic terminal version of StarView has all the basic features 
of StarView, and you may find it to be faster if you are logging in to the 
archive host computers over a slow network connection. If you have access to 
X-Windows, you may wish to install Distributed StarView on your home 
computer (see “Distributed StarView” on page 22). 

To use the X-windows version of StarView type xstarview, for the 
terminal version type starview. If you are using the X-windows version, 
you will have to provide permission for StarView to display on your local 
machine. X-StarView will tell you how to do this when starting. 

In Chapter 3 of this primer you can find a tutorial to using the archives 
with StarView, which provides you with all the basic information you need to 
use StarView to access the HST archive. More detailed information about 
StarView and the HST archive can be found in the HST Archive Manual, (see 
page 21). 


Getting Your Data 

Registered users can retrieve moderate amounts of HST data from the 
HST Archive by submitting a data retrieval request through StarView. After 
you have submitted your request, the archive system will process it. You will 
be notified by e-mail when it is complete. The message will go to the e-mail 
address that you specified on your archive account registration form. If you 
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choose to retrieve the data to the archive host machine, it will be 
written to a subdirectory of the data disk. Each data retrieval 
request will be in its own subdirectory, identified by the request ID 
number (which StarView displayed when you requested the data 
and which will be included in the notification message). To find 
your data, type: 

% data -4 Go to data disk 

% cd user0123 •* Go to your subdirectory 

% dir List files In directory 

Data retrieved from the HST Archive is in VAX-specific GEIS 
format when it is placed on the disk. To convert files to Unix 
format, you can use the task vax2sun. To convert tables to Unix 
format, use the tconvert task. To convert GEIS files to FITS 
format prior to transferring to your home computer via FTP, you 
can use the standalone task stwf its. 

The following sections explain how to retrieve, convert, and 
transfer your data. Because we have many users, the disk space 
available to each user within the data directory is limited. The 
files you create in the data directory are temporary. Files in this 
area are deleted automatically after two days. However, we would 
appreciate your deleting your files from the archive host computer 
after you successfully copy your files to your home computer. 


Converting File Formats 

Files that StarView retrieves from the archive are presently 
VMS-format GEIS files. GEIS files come in pairs, consisting of a 
header file and a data file. If you plan to use the Space Telescope 
Science Data Analysis System (STSDAS) on a VMS system to 
analyze the data, you can directly transfer the retrieved files using 
FTP back to your home computer. If you plan to use STSDAS on a 
Unix system, you will first need to convert the GEIS files to Unix 
format using the STSDAS tool vax2sun (see below) because 
GEIS format is operating-system dependent. When using 
vax2 sun on the archive host machines, the original files will be 
removed. You can also do these same conversions from within 
IRAF on your home institution’s computer, if you are using ERAF 
there. 


The vax2sun conversion works only for GEIS files. To convert 
calibration tables to Unix format, use the tconvert tool. 
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If you do not plan to use the STSDAS software to analyze your data, you 
will want to convert your data to FITS format using the stwfits tool 
before using FTP to move files to your home computer. Users on STDATU 
must first convert their files to Unix-format GEIS files before converting them 
to FITS (i.e., first run vax2sun, and then run stwfits). Note that FITS 
files are operating-system independent. 

GEIS files come in pairs: a header file with an extension ending in “h” 
(e.g., xOOcOlOlt. cOh) and a data file with an extension ending in “d” 
(e.g., xOOcOlOlt.cOd). FITS combines these two files into a single data 
file. 

See “Getting Your Data” on page 43 for detailed instructions about the use 
of vax2sun and stwfits. 


Using FTP 


You can use FTP to transfer files from the archive host computers to your 
local computer. This includes any of the ASCII files, such as the PostScript 
versions of the HST Archive Manual or HST Archive Primer, or binary data 
files that you retrieved from the HST archive using StarView. 

If you wish to retrieve any ASCII text file, including PostScript 
documents, you can use the ASCII transfer mode. Set the mode by typing 
ascii at the ftp> prompt. Binary files, including GEIS and FITS data 
files, must be transferred in binary mode. Type binary at the ftp> 
prompt. Tables 2.2 and 2.3 show the commands you would use to retrieve 
files if you logged in as registered or guest users. 


Function 

FTP Commands (VMS) 

FTP Commands (Unix) 

Retrieve HST data 

ftp stdata.stsci.edu 

cd disk$ stage : [DMF_STAGE] 

cd [ . oort012 9 ] 

binary 

mget X*.* 

ftp stdatu.stsci.edu 
cd /stdatu/dmf_stage 
cd oort0129 
binary 
mget x* 

Retrieve PostScript 
version of manual 

ftp stdata.stsci.edu 
cd disk$stdataO : [documents] 
cd [.manuals] 
ascii 

get archive_manual.ps 

ftp stdatu.stsci.edu 
cd /stdatu/test 1 /guest /document s 
cd manuals 
ascii 

get archive_manual.ps 

Retrieve your 
starview . log 
file from your home 
directory 

ftp stdata.stsci.edu 
ascii 

get starview.log 

ftp stdatu.stsci.edu 
ascii 

get starview.log 


Table 2.2: FTP Commands for Registered STDATA and STDATU Users 
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Function 

FTP Commands (VMS) 

FTP Commands (Unix) 

Retrieve PostScript 
version of manual 

ftp stdata.stsci.edu 
cd disk$stdata0 : [documents ) 
cd [.manuals] 
ascii 

get archive_manual.ps 

ftp stdatu.stsci.edu 
cd documents/manuals 
ascii 

get archive_manual.ps 

Retrieve your 
starview . log file 
from your home 
directory (if your 
directory is called 
mydi rectory) 

ftp stdata.stsci.edu 
cd mydirectory 
ascii 

get starview.log 

ftp stdatu.stsci.edu 
cd data/mydirectory 
ascii 

get starview.log 

Table 2.3: FTP Commands for Guest Users 


Documentation on the Telescope, Instruments, 
and Data 


You can obtain a wide range of technical documentation on the 
telescope, its instruments, and HST data from the User Support 
Branch (USB). The USB serves as a central contact point between 
the scientific community and STScI. Contact the USB at: 

User Support Branch 

Space Telescope Science Institute 

3700 San Martin Drive 

Baltimore, Maryland 21218 USA 

Phone: (800) 544-8125 (in USA), or (410) 338-4413 

E-mail: usb@stsci . edu 

Some of the documentation available from USB includes the 
following. These documents are also distributed to astronomical 
libraries. 


• HST Archive Primer, version 4. 1 , May 1994 

• HST Archive Manual, version 4.0, December 1993 

• HST Data Handbook, version 1 .0, February 1 994 

• STSDAS User’s Guide, version 1.3, April 1994 

• FOC Instrument Handbook, version 4.0, February 1993 

• FOS Instrument Handbook, version 4.0, February 1993 

• GHRS Instrument Handbook, version 4.0, January 1993 

• WF/PC Instrument Handbook, version 3.0, April 1992 
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• WF/PC 2 Instrument Handbook, version 1 .0, March 1993 

• FGS Instrument Handbook, version 3.0, April 1992 

• OTA Handbook, version 1.0, May 1990 

• Target Acquisition Handbooks, version 2.2, January 1992 

• Calibration Status and Plans, version 2.0, June 1992 

• The GO and GTO Observing Programs, version 3.0, May 1992 

• STEIS instructions 
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HST Data Handbook 

The HST Data Handbook provides a comprehensive guide to all 
major aspects of HST data reduction and analysis. The handbook 
describes the contents of each dataset, how to display HST images 
and spectra, ways to identify and correct problems in your HST 
data, and instructions for doing common analysis and image 
reconstruction tasks. The handbook assumes no prior knowledge of 
HST data, the IRAF or STSDAS systems, or any specific 
knowledge of HST instruments, other than that required to have 
prepared an observing proposal. 

The HST Data Handbook is currently shipped to observers 
along with their data tapes. It was also sent to guest observers 
whose observations occurred during the past year. The HST Data 
Handbook is available upon request from the User Support Branch 
(usb0stsci . edu). 


Using STSDAS to Analyze Your Data 

You can analyze or recalibrate HST datasets using STSDAS. A 
comprehensive discussion of STSDAS features or a tutorial on 
how to use the software is beyond the scope of this manual. To 
learn how to use the system for doing data analysis, you can 
request copies of the documentation by sending e-mail to 
usb@stsci.edu. Contact the STSDAS hotseat 
(hot seat @stsci . edu) for answers to any STSDAS-related 
questions that you may have.. 


Reading Text Files in the Documents Directory 

The documents directory on the archive host computer and 
its subdirectories contain ASCII files that are of interest to archive 
users. To get to the documents directory from any point, type 
docs. Within this directory is an ASCII file called 
documents . list that contains a list and brief description of 
all documents maintained in this directory and in its subdirectories. 
Each subdirectory also contains its own listing file whose name is 
of the form <subdirectory> . list. For example, the 
manuals directory contains a file manuals. list that 
explains the contents of files in that directory. 

The ASCII files in the documents directory can either be 
searched online or they can be transferred back to your host 
computer using FTP (see “Using FTP” on page 17). 
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Manuals 

PostScript files of the latest versions of the HST Archive Manual and the 
HST Archive Primer are kept in the manuals subdirectory of the 
documents directory. To get to this directory from the documents 
directory, type: 

$ cd manuals 

The primer provides all the basic information needed to search the HST 
catalog and to retrieve HST data using the STScI archive host computers. The 
HST Archive Manual provides more detailed information about StarView and 
its higher level functions, and about the design of the HST Catalog and 
Archive. 


Forms 

Forms related to archival research, such as the HST Archival Data 
Request, HST Data Distribution, HST Archive Account Registration, and HST 
Archival Research Visit Request, are maintained as PostScript files in the 
forms subdirectory of the documents directory. 


Exposure Catalogs 

The Archived Exposures Catalog (AEC) and the Planned and Archival 
Exposure Catalog (PAEC) are located in the exposures subdirectory 
under the documents directory. Both the AEC and PAEC come in two 
versions — one that contains all targets and is ordered by RA and one that 
contains just solar system targets and is ordered alphabetically by target name. 

The AEC is updated monthly. The AEC is an ASCII list of observations in 
the HST Archive and contains information such as the target name, position, 
instrument, mode, and date on which the data become non-proprietary 
(publicly accessible). Information provided in the AEC is a selected subset of 
the keyword information stored in the HST catalog. The AEC is produced 
through an automated search of the catalog. For more information, see “The 
AEC and the EC” on page 5-23 of the HST Archive Manual. 

The PAEC is labeled PAEC . CAT. The PAEC is an ASCII listing of all 
HST targets approved for observation including all general observer (GO) and 
guaranteed time observer (GTO) observations. Thus, the PAEC includes 
information for all executed and planned HST observations. Both the PAEC 
and the AEC are also maintained on the Space Telescope Electronic 
Information System (STEIS). The PAEC is also stored as a table in the HST 
archive database and can be examined from within StarView using the 
duplication Check> search screen. (See page 51 for a tutorial). 


Target RA and Dec in the AEC and PAEC are in J2000 coordinates. 
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Target Cross-Correlation Program 

We are currently developing a feature in StarView that will 
allow you to cross correlate a list of target RA and Dec positions 
against the catalog all at once. When available, you will be able to 
use this feature by selecting the “Cross Correlation” option under 
the “Constraint” menu within any search screen that contains an 
RA and Dec field. 

For now, we have provided a tool that correlates the list of 
exposures in the AEC against a separate list of targets that you 
provide. You can use this cross-correlation program to find all of 
the exposures in the AEC for targets on your list. In this way you 
can quickly determine which of the targets have been observed 
with HST and with what observation parameters. This is a 
particularly useful tool when you have a long list of targets, which 
would otherwise require a substantial number of catalog searches 
on one of the StarView search screens. 

To invoke the cross-correlation program on either archive host 
computer, type the following: 

$ corr <parameter_file> 

where parameter_file represents the name of a file contain- 
ing the various parameters involved in the cross-correlation (e.g., 
the target list file name, the equinox of the coordinates, the search 
radius around the target positions within which to search for entries 
in the AEC, and the list of HST instruments to be included in the 
search). To find out the format for this parameter file and how to 
run the corr program, get the help file HOW-TO-USE from the 
document s / exposure s / corr directory on STDATU. 


Distributed StarView 

Running X-windows across a network can be slow when the 
network is busy; we have therefore developed a client-server 
version of StarView that runs on your local machine and sends a 
request to our data base server when it needs information. The 
performance improvement of the distributed code is evident in 
most X-starview functions, but is most apparent when previewing 
images because the client-server software sends the image across 
the network in a compressed form. 

Distributed StarView has all of the capabilities of StarView run 
from the archive host machines, including the ability to retieve data 
from the archive. The data can be written to a tape which we will 
mail to you, or can be written to disk on the archive hosts for later 
transfer to your home computer via FTP. If it is run from a Unix 
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machine, Distributed StarView will place the data on the Unix archive host 
(STDATU) but if run from a VMS machine the data will be put on the VMS 
host (STDATA). See “Getting Your Data” on page 15 for more information 
on retrieving data via FTP. 

At this time (May 1994), distributed StarView is available for Sun 
computers. A VMS version may be released in the near future. Use the 
readnews command on STDATU or STDATA for more information on how 
to obtain this software. 

Unfortunately, due to U.S. regulations prohibiting the export of software 
containing encryption algorithms, the distributed version of StarView can 
only be provided to users in North America. 
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StarView 

Tutorial 


in This Chapter... 

StarView Tutorial/ 26 

Conflict Checking for Cycle 5 Proposals / 46 
Tutorial: Retrieving Calibration Reference Files/ 45 


StarView is the user interface to the Hubble Space Telescope data archive. 
Using StarView, you can: 

• Browse the contents of the archive. 

• Select observations that interest you. 

• Preview public data in real time. 

• Retrieve data from the archive for scientific analysis. 

• Select and retrieve calibration files to recalibrate HST data. 

• Get information about planned but not yet executed observations. 

StarView is fairly inituitive and many users find they can navigate through 
StarView using only the online help (use the [Strategy] button on any screen 
or the pull down |Help| menu in the menu bar). 

In this Chapter we present two tutorials designed to guide you through 
StarView and its principle uses. These tutorials include: 

• A complete StarView session, including logging in, selecting observa- 
tions, retrieving data, and transferring that data via FTP from the 
archive host computer to your home computer. 

• A tutorial on selecting and retrieving calibration reference files. 


A tutorial session on using the <Duplication Check> and <Proposal 
Abstracts> screens to search for potential conflicts when preparing Cycle 5 
HST Proposals is provided in Chapter 4 on page 5 1 . 
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StarView is available in two forms: 

• An X-Windows based version (xstarview). 

• A terminal version for basic terminals, such as a VT 100. 

The X-Windows version of StarView allows you to preview 
public HST data, however, all the other basic functions of StarView 
are available in the terminal version and you may find it faster if 
you have logged into the archive host computers over a slow 
network connection. 



If you have any questions or problems using the archive, contact 
the HST archive hotseat via e-mail, archive@stsci.edu, or 
phone (410) 338-4547. 


StarView Tutorial 


In this section, a whole StarView session is presented, from 
logging in to the host computers through using FTP to move the 
data from the archive host to your home computer. A second 
tutorial on selecting and retrieving calibration reference files is 
provided on page 45. 

1 . Access the STDATU (or STDATA) computer using telnet. 1 

% telnet stdatu.stsci.edu 
Connected to stdatu.stsci.edu. 

Escape character is 

Login: username 1 Type your username and 

Password: password password at the prompts 



If you are logging in as a guest, use the username “guest” and pass- 
word “archive”. 


After logging in, some introductory me ssages will appear on 
your screen. To see more of the text, press [Space l To quit, press 

RH . 

You can read additional archive-related information by typing: 

% readnews 


1. Users at STScI can access StarView directly from their own work- 
stations or terminals — they need not log in the archive host computers, 
which are maintained exclusively for off-site users. 
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2. Start the X- Windows version of StarView 2 (or start the terminal version, 
as described below) by typing: 


% xstarview 

In xstarview you will be asked for your X display host name. You should 
respond with the name of your home workstation. You will then be instructed 
to give STDATA or STDATU permission to write to your screen; to do this on 
a Unix workstation, you need to add “stdatu” to your computer’s x host fi le 
by typing the following line in another window and then pressing Return] to 
continue: 


% xhost +stdatu. stsci .edu 

If you are using a DEC workstation, you would give the system permis- 
sion to write to your screen by going to the menu bar of your Session 
Manager and pulling down the |Customize| menu and choosing the 
Security option. You then set: 

• “NODE” to “stdata.stsci.edu”. 

• “USERNAME” to either or your username on STDATA. 


. “TRANSPORT” to “TCPIP”. 

If you want to use the terminal version instead, you would type: 


% starview 

In the terminal version, you will be asked to confirm your terminal setup. 
For example: 


xterm 24 x 80 [Y] 
If this is correct, press 


.litWjU). 


to continue. If this is not correct, then 
answer “no” by pressing I n 1 followed by [Return! If you answer “no,” you 
will then be asked some questions about your terminal type, number of lines, 
and number of columns. Type a question mark (1 ? I) to get help about your 
options. 

The StarView session is then started; messages will be displayed telling 
you what is happening (e.g., data dictionaries being loaded). This process will 
take about a minute to complete. 


Welcome Screen 

The StarView <Welcome> screen (Figure 3.1) will appear (this and all 
subsequent screens are taken from the X-Windows version). There is an initial 
message at the bottom of the screen telling you that the system is “Loading 


2. The X-Windows version of StarView is also available as distributed software 
which you install and run on your home computer. By running the xstarview client on 
your own computer, you avoid the overhead of running the software over the net- 
work, giving you a considerable speed improvement. For information about how to 
install xstarview on your home system, use the readnews command on stdatu or 
stdata, or contact the archive hotseat 
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the SQL query generator...” While this load is taking place, read 
the welcome text. If there is any urgent archive news (e.g., a 
message about possible system downtime), it will appear at the top 
of the welcome text. While the loading takes place, any input from 
your terminal keyboard will be ignored (i.e., flushed from the input 
buffer). 


Menu 
bar - 


Work 

area 


Command 
box ► 


a 


< Welcome > 


File Searches Coanands Options Coaaents 


Help 


Welcome to StarView - Release 3.3 


StarView Is the user Interface to the Hubble Data Archive, providing 
access to the catalogs that document the contents of the HST Archive. 
This Is the Initial public release of the X-windows version of 
StarView. In addition to possessing all of the features of the 
CRT-based version, XStarVlew allows the user to preview coapressed HST 
data. The use of XStarVlew Is Intended to be Intuitive. It Is our 
hope that Individuals with experience with other X-based prograas will 
find the Interface quite straightforward. The CRT version Is, of 
course, still available for those tdio would prefer to use It or do not 
have access to an X display. Any suggestions or coaaents on XStarVlew 
will be gratefully received. Please send thea to arch1vettstsd.edu. 

You aay use StarView to browse the HST Catalog and preview data at any 
tlae. Most coaaon catalog searches can be carried out using the QUICK 
SEARCH screen, vrfilch is activated by pressing the [Quick Search] 
pushbutton coaaand below. A wider variety of search options Is 


B 




'"'Or 

(Quick Search] 

(Duplication Check] |other Searches] 


| Strategy! 

(Exit StarView *x| 








d 


Figure 3.1 : Welcome Screen 


You can scroll through the text and read any additional 
information below the display area by using the scroll bar on the 
X-windows version of StarView. On the terminal version (for 
VT100 or other basic terminals), use the arrow keys or page up by 


pressing rcontrcH - Tyn and page down by pressing 


SSESl 


Command Usage and Screen Interaction 

In the X-windows version of StarView: 

• Use the mouse to select all functions. 

• Choose options by positioning the mouse pointer over the 
command button or menu and pressing the left mouse 
button. 


In the terminal version: 


Press 


,353551 


-m to cycle through the three screen areas 


(menu, work area, and command box). 
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• Use the arrow keys to move around within any one portion of the 
screen. 

• Whenever an option is highlighted, press [Return] to invoke the high- 
lighted function. 

On the terminal version, you can use the command accelerators to invoke 
functions (i.e., run commands). Some command buttons show accelerators 
such as “ A N”, which means the function or command can be invoked by 
pressing down on the [Control] key while simultaneously pressing the HH key. 
Other commands show accelerators such as “E+n ”, wh ich means that you 
would press the [Esci (escape) key followed by I N 1 Table 3. 1 lists the 
commonly used command accelerators. 


Keystroke 

Function 


Cycle through the three screen areas (menu bar, work 
area, and command box) 

[ContrpH W 1 

Return to previous screen 

fControVf Xl 

Exit StarView 

[ControVf O ] 

Display strategy help (context sensitive) 

sm 

Refresh screen display 


Table 3.1 : Command Accelerators (Terminal Version) 


Searching the Catalog 

To search the catalog: 

1 . Choose a search screen. 

2. Specify your search criteria, such as position and a release date before 
today’s date so that you get public data. 

3. Start the search by clicking on the [Begin Search] button. 

4. Step through subsequent found observations looking for those of interest 
to you. 

In this example we use the <Quick Search> screen to search the HST 
catalog. 


The <Quick Search> screen is useful for most basic searches of the HST cata- 
log. An extensive set of more detailed search screens are also available. To 
choose one of these, click on [Other Searches] or pull down the |Searches| 
menu from the menu bar. Figure 3.15 on page 46 shows the <Other Searches> 


screen. 
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The Quick Search Screen 

Choose the <Quick Search> screen by clicking the [Quick 
Search] button. As described here, clicking in xstarview is done by 
moving the cursor to the command button and pressing the left 


mouse button. In the terminal version, either (1) use [c sen to 
move the cursor to the command box, and the arrow keys to move 
the cursor until the button is highlighted then press [Return! or (2) 


press IControJ - m the accelerator for the QuickSearch command. 

The <Quick Search> screen is shown in Figure 3.2. We will use 
this screen to search for all publicly-available 3C273 observations. 



Figure 3.2: Quick Search Screen 

Specifying Search Criteria 

There are various ways to search for observations of a particular 
target in the catalog. The easiest way is to enter the name (which 
you should embed in qualifiers, or wildcard characters, e.g., 
*mars*) in the target field. Because observers do not necessarily 
use the same convention to name sources, this will typically not 
return all observations of a given source. The best way to be certain 
you retrieve all observations of a given target (for stationary 
targets) is to search for observations within a given (radial) 
distance of your source’s position by entering constraints in the 
RA, Dec, and search radius fields on the <Quick Search> Screen. 
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If you do not know the RA and Dec of your target, you can run the SIMBAD 
coordinate resolver from within StarView. The SIMBAD resolver automati- 
cally determines the target’s position using a network connection to the 
SIMBAD database in Europe, it then populates the RA and Dec fields on the 
search screen with this information. Click on the [SIMBAD Coordinates] 
button to invoke this option (see Figure 4.1 on page 52). 


In this case, we know the coordinates of 3C273, so we enter the RA and 
Dec for 3C273 and a search radius of 10 arcminutes in the corresponding 
fields on the search screen. 

We want imaging observations, so move to the “Instrument” field. The 
valid HST instruments are: 

• Fine Guidance Sensors (FGS). 

• Faint Object Camera (FOC). 

• Faint Object Spectrograph (FOS). 

• Goddard High Resolution Spectrograph (GHRS). 

• High Speed Photometer (HSP). 

• Wide Field/Planetary Camera (WFPC). 

• Wide Field Planetary Camera 2 (WFPC2). 

The FOC, WF/PC, and WFPC2 are the HST’s imaging instruments, so 
type foe, wfpc, wfpc2 in the “Instrument” field to find imaging 
observations — StarView interprets the commas to be “or”. 

We want public data, so now specify that we want data released prior to 
today’s date. For example, move to the “Release date” field and enter 
<1 -May- 9 4 for any datasets that were released before May 1, 1994. 

Figure 3.3 shows how the <Quick Search> screen looks at this point. 
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® < Quick Search Specification > 


File Searches Constraint View Retrieve Customize Options Consents Help 


RA(2000) 
Dec (2000) 


12 29 6.7 


Search radius (arcaln): | 10.000 [ 

(To search a circular region, enter RA, DEC, and search radius) 
Target nane: | 

Target category: 

Target description: 

Instrunent: FOC,MFPC,W 

Proposal ID: 

PI (last naae): | 

Release date: I <01 -MAY-94 ^ 1 


Enter search constraints In one or sore of the fields above. 
Use TAB key or aouse to aove between fields. 


Begin Searchl ISIMBAD Coordinates! {Clear Constraints 


View Results 


Exit Screen 


Strategy 


MESSAGE: Enter search constraints, press [ Begin Search 1 when ready. 


Figure 3.3: Quick SearchScreen With Constraints Entered 

To help you understand how you can constrain searches, 
Table 3.2 lists the qualifiers available to you within StarView. 
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Operator 

Function 

= 

Equal to 

!= 

Not equal to 

> 

Greater than 

>= 

Greater than or equal to 

< 

Less than 

<= 

Less than or equal to 


Range 

, (comma) 

List 11 

* 

Wild card 


a. Do not use commas in date fields (exam- 
ple May 1, 1994) — use dashes instead. For 
example. May- 1-94. 

Table 3.2: Relational Operators for Constraining Searches 


Getting Help in StarView 

Use the [Strategy] button to get information about using any StarView 
screen, or use the pull down [Help] in the menu bar to see all the available 
StarView help. 

To get help on the valid ranges for any field, use the field help. In 
xstarview, move the cursor to the field and press the right mouse button (or 
press the [ Help 'l button, often located in the bottom left comer of your 
keyboard). In the terminal version, move the cursor to the field and press 


,S5E5j 


Starting the Search 

Click on the [Begin Search] button to search the catalog for the 
observations satisfying your search criteria. If none are found, a message will 
appear at the bottom of the screen, and you will need to enter different search 
constraints. If at least one observation is found, the screen will change to the 
<Quick Search Results> screen. 

The <Quick Search Results> screen (Figure 3.4) shows the results of your 
catalog search. The first record that matches your search criteria will be 
displayed. 
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HIT 

< Quick Search Results > 

^ 

File 

Searches Constraint View Retrieve Customize Options Comments 

Help 

. 


Proposal ID: 1 1116 
Dataset name: 
RA<2000>: 


PI (last t 




i): I MESTPHAL 


HOHDOGOIT 


Release date: | 02/25/92 15:23:34 


Harked: 


12h 2% 6.37 


Dec <2000): I +2d 3 m 3.676s 


Equinox: | J200Q 


Target name: 
Category: 


3C273-0FFSET 


Moving (T/F>: 


□ 


GALAXY 


Description: [ GALAXY? QUASAR; 


Instrument: j UFPC | Config: | PC 
Filter /grating 1; | F555M 


Optical Mode: 


Apertire U 
Exposure time <s): 
Quality 1: 

Quality 2: 


OBJECT IN PC 5 INSTEAD OF PC 6 


OBJECT VERY CLOSE TO EDGE OF CCD 


P6 

2: 


3: 1 

4: 

1 

2.600 

Start: 

02/25/91 06:57:12 

Flag: 

| NORMAL 



|Step Forward | 

[Step Back| |hark Dataset | 

[Retrieve Harked Data| 

[Scan Forward) 

|Scan Back| [Urwark Data | 

lltrite Result to File) 

[Edit Search Constraints | [Hark All 

1 [View Result as Table | 


Record 1 of 1 (in progress) |Uhmark All 1 | Strategy | [Preview] 

[Exit Screen"*?] 


^MESSAGE: More records available. Use record controls to view —arch results 




Figure 3.4: Quick Search Results Screen With Record Display 

Viewing Subsequent Found Observations 

If you want to scan the full list of your search results: 

• Click the [Step Forward] button to view one record at a 
time. 

• Click [Scan Forward] to see all of the found records in 
rapid succession. Press any key to stop the scan. 

• To go back to previous records, use [Step Back] or [Scan 
Back] buttons. 

Another way to view your search results is to use StarView’s 
<Table Format> screen. Click on [View Result as Table] to see a 
page of catalog records at the same time (see Figure 3.5). Click on 
[View Result as Form] to return to the single-record screen 
format. 
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< Search Results - Table Format > 



File Searches Constraint 

View Retrieve Customize Options Cow worts 

Help 


□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 



11 <HI" ih'llT I 

f o:/yj/32 

;c:'73-OFFSET I 

F 

IMhL-E 

FTOI 

2 . b 1 M J 

UESTF'HhL 

1116 

UOHD0602T 

02/25/92 15: 

3C273-0FFSET 

PC 

IMAGE 

F785LP 

5.000 

UESTPHAL 

1116 

U0HD0603T 

02/25/92 15: 

3C273-0FFSET 

PC 

IMAGE 

F555H 

40.000 

UESTPHAL 

1116 

HOHD0604T 

02/25/92 16: 

3C273-CFFSET 

PC 

IMAGE 

F785LP 

70.000 

ICSTPHAL 

1116 

U0HD0605T 

02/25/92 16: 

3C273-CFFSET 

PC 

IMAGE 

F785LP 

300.000 

UESTPHAL 

1116 

H0HD0606T 

02/25/92 16; 

3C273-0FFSET 

PC 

IMAGE 

F785LP 

300.000 

UESTPHAL 

1227 

XOLAOIOIT 

02/24/93 16: 

3C273 

FOC/96 

IMAGE 

CLEAftl 

1301.125 


1227 

X0LAO3O2T 

03/01/93 22: 

3C273 

FOC/280 

IMAGE 

CLEAftl 

995.750 


1227 1 

XOLAQ102T 

02/24/93 22: 

3C273 

FOC/96 

IMAGE 

F4ND 

277.125 

B0KSENBEF 

1227 

XOLA0201T 

03/01/93 22: 

3C273 

FOC/96 

IMAGE 

CLEARl 

1002.125 

B0KSENBEJ 

1227 

X0LA0202T 

03/02/93 15: 

3C273 

FOC/96 

IMAGE 

CLEAR! 

1195.750 

BOKSENBG 

1227 

XOLA0203T 

03/01/93 22: 

3C273 

FOC/96 

IMAGE 

CLEAftl 

995.750 

B0KSENBEF 

1227 

X0LAC2O4T 

03/01/93 22: 

3C273 

FOC/96 

IMAGE 

CLEAftl 

995.750 

mat* 

1227 

X0LAO3O1T 

03/01/93 22: 

3C273 

FOC/286 

IMAGE 

F2ND 

995.750 

l ms 

2451 

X0U20101T 

01/05/93 17: 

3C273-JET 

FOC/96 

IMAGE 

POLO 

1445.875 

| THOMSON 



(Previous Page] 

|hark Dataset | 

(Retrieve Datasets | 

[IW«?g|§ 

[First Page j 

(Umwrk Data | 

(it-ita Table to File| 

(Edit Search Constraints 

] (Mark All 

] (View Result as Forw| 


Record 15 of 15 <ln process) |Unwerk fill ] [Strategy | (Preview] 
(Exit Screen *z] 


^MESSAGE: hore records available* Use record controls to view search results 




Figure 3.5: Quick Search Results Displayed on the Table Format Screen 


Preview 

If you are using xstarview, use the [Preview] button to get a quick look at 
the data. This can help you decide whether or not to retrieve a dataset. 
Preview displays compressed HST images (not suitable for science analysis), 
as well as FOS or GHRS spectra. Only public data is available for preview. 
Figure 3.6 shows an example of datasets viewed with the [Preview] 
command; spectra and images are displayed differently, and the figure shows 
both an FOS spectrum and a WF/PC image. Preview is not available in the 
terminal version of StarView. 
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Figure 3.6: Previewing a Dataset 
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Retrieving Datasets From the Archive 

We now want to retrieve the data that the catalog has identified. To do this, 
you will mark the data for retrieval and then do the retrieval. There are several 
steps in this process: 

1 . Mark the observations that you want to retrieve; you can mark them either 
individually or as a group. 

2. Display and review the list of datasets to be retrieved. 

3. Specify the file formats and media to be used in the retrieval process. 

4 . Submit the request. 

5 . Check the request status, if desired. 


If you do not have an archive account, then you will not be able to retrieve 
data until you have registered with STScI. For information about how to reg- 
ister, see page 14. 


Marking Observations for Retrieval 

To mark for retrieval the dataset displayed on the screen, click the [Mark 
Dataset] button. This action will be confirmed by a message at the bottom of 
the screen. Also, the “Marked" field, in the upper right comer of the screen, 
will display T (True) indicating that the dataset has been marked for 
retrieval. 

You can mark datasets for retrieval in either the table-row format display 
screen, in which case the highlighted record is marked, or on the <Quick 
Search Results> screen with the record displayed. 

If you want to mark for retrieval all of the records matching your search 
criteria, click on the [Mark All] button. This could be a large volume of data, 
and it would be for the 3C273 search request described here. Alternatively, 
step through your search results records by clicking on the [Step Forward] 
button and only click on the [Mark Dataset] button for a few of the 
observations. 

Reviewing the Retrieval Request 

Once you have marked records for retrieval, you begin the retrieval 
process by displaying and reviewing a list of datasets to be retrieved. To do 
this: 

1. Click on the [Retrieve Marked Data] button to exit the <Quick Search 

Results> screen and to begin the retrieval process by bringing up the 

<Archive Retrieval screen. 

2. Review the list of datasets. 

The <Archive Retrieval screen lists all of the datasets that you have 
marked for retrieval. In this case, you would see something like Figure 3.7. 
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r 0 

< Archive Retrieval > 

*1 

file View Coaaands Cements 


Help 


□ 

□ 

□ 

□ 

a 

□ 

□ 

□ 

□ 

□ 

□ 





1 [ rim E 

1 i L t nk l I 

1 Ir'.U.l 1 

1 n :'/:a vj I INfEkkMF Tt 1 

rrx 

1227 

X0LA0102T 

02/24/93 

3C273 

FOC/96 

IMAGE 

F4HD 

277*12 

02/24/92 

INTERRUPTS 

12h 2% 

1227 

X0LA0201T 

03/01/93 

3C273 

F0C/9G 

1HACE 

ESI 

1002.1 

03/01/32 

INTERRUPTS 

12h 29a 

1227 

X0UWJO2T 

03/01/93 

3C273 

F0C/28B 

IMAGE 



03/01/92 

NORMAL 

12h 29a 





















































































































\WM 

11 

111 

M 

Ml 


(Next Page of Datasets f 


[Previous Page of Datasets | 


[Add Datasets by Kwe \ 

irai.ni 


jftdd Datasets froa File | (nark All Datasets "| 
Total datasets currently marked for retrieval: 4 


^MESSAGE: Review select! ora. Push [Subait Request] to continue with retrieval. 


Figure 3.7: Archive Retrieval Screen 

Review the list of datasets that you have marked for retrieval. If 
you have marked several datasets, you may need to click on the 
[Next Page of Datasets] button to see additional screens of marked 
records. The total number of datasets that you have marked for 
retrieval is shown near the bottom of the screen. 

Specifying Formats and Media 

1. Continue with the data retrieval process by clicking the [Sub- 
mit Request] button. 

2. Specify the files that you want to retrieve. 

3. Specify the type of media (file transfer method) that you want. 

When you click the [Submit Request] button, the <Retrieval 
Request - File Options> screen is displayed (Figure 3.8). 
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^0 

< Retrieval Request - File Options > 

1 

£11 e Conaands Coaaents 


Help 


If you do not have an archive account, please contact the Archive Hotseat. 
Phone: 410 - 338-4547 Eaa11 : archl veGstscI .edu or STSCIC: : ARCHIVE 


Science Files Requested: (all other marked files are retrieved as requested) 

■ Calibrated ... all calibrated science data files 

t □ Uncalibrated ... raw data; uncallbrated science data files 

■ Data Quality ... reports describing science data quality 

(Use TAB key or nouse to Hove to an option, then use Mouse button to select the option.) 


Jl 




|use Default File Options I 

Isubalt Request| | Exit Screen A Z| 


(Override Standard File Options 

(strategy A o| 





^MESSAGE: Review selections. Push 

[Subalt Request] to continue with retrieval. 

J 


Figure 3.8: Retrieval Request - File Options Screen 

The <Retrieval Request - File Options> screen indicates the kinds of files 
that will be retrieved, in this case the calibrated science data files and the data 
quality report files will be retrieved. These defaults are acceptable. 3 Click the 
[Submit Request] button to continue with the retrieval process. To help you 
determine the amount of data that you are requesting, Table 3.3 lists typical 
file and dataset sizes for each instrument 


3. You can override the defaults and provide your own file extensions by using 
the [Override Standard File Options] button. 
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Instrument 

Mode 

Single File Size 

CAL Class 
Size 

FOC 

normal 512 x 512 

1 MB 

-4 MB 


zoom 1024 x 512 

2MB 

8-10MB 

FOS 

normal 

20-80 KB 

<500 KB 


rapid readout 

>4 MB 

>10 MB 

GHRS 

normal 

20-80 KB 

<500 KB 


rapid readout 

>4 MB 

>10 MB 

HSP 

normal 

-40 KB 

-500 KB 


occasional 

>125 MB 

>1 GB 

WFPC, WFPC2 

normal (full mode) 

10 MB 

26 MB 


area mode 

2.5 MB 

7MB 


Table 3.3: Average Data File Size per Instrument 


The <Retrieval Request - Media Options> screen is then 
displayed (Figure 3.9). You will nee d to enter your archive user 
name and password, pressing [Return! after each entry. 


r 0 < Retrieval Request - Media Options > 

n 

File Comands Cements 

Help | 


If you do not have an archive account, please contact the Archive Hot seat. 
Phone: 410-338-4547 Enail: archlve8stsci.edu or STSCIC: : ARCHIVE 


frchive U ae rnawe: | aas 
Archive Password: r 


Media: 

^ Local Area Network <G£IS only) 

Exabyte 8hn cassette 
<>EXA 9 Track Hag Tape, 8250 bpi 

O^HT6 ^ Tape, 1600 bpi 

OHT1 

(Use TAB key or nouse to nova to an option, then Return to select the option.) 


| Subnit Request] |Use Default Options'] [Exit Screen *Zj [Strategy ~p| 
JESSAGE: Review selections. Push tSUwlt Request! to continue with retrieval, j 


Format: 

4GE1S 

^FITS 

(FITS is not available 
over LAN at this tine) 


Figure 3.9: Retrieval Request- Media Options Screen 
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The screen will indicate LAN (local area network) as the default 
distribution medium. This is acceptable — your data will be retrieved to a 
subdirectory of the data disk on STDATU. You will then be able to ship it 
electronically from there to your home computer via FTP, as described in 
“Getting Your Data” on page 43. Also indicated on the screen is the default 
data format, which is GEIS. This is also acceptable if you plan to use the 
STSDAS package for your data analysis. 


Note that your retrieved files will be in VMS format. If you are using a Unix 
system, you will need to convert the files to Unix format using the vax2 sun 
task, as described later in this chapter. 


Submit the Request 

After you select the file and media types, you will submit your request. To 
do this: 

1 . Begin request submission process. 

2. Display and edit a list of actual file names to be retrieved (if desired). 

3. Submit the request. 

4. Exit the retrieval screens and return to StarView. 

Click on the [Submit Request] button to begin the submission process. 
The archive system will validate your archive account information and then 
map the marked datasets to the corresponding list of data files. 

You will be asked if you want to edit the list of requested files before 
submitting t he retri eval request for final processing. The default answer is 
“no.” Press [Return] if you wish to skip the edit step and have StarView 
continue processing your request. 

StarView verifies that your requested files are public and that the total 
amount of requested data is within allowable limits. 

If these tests are successful, your retrieval request will be submitted; the 
system will display a message on your screen along with a request ID 
(retrieval request identification string). Figure 3.10 shows how a StarView 
screen might look at this stage. 


Write down the request ID. You will need it later to check the status of your 
retrieval request and to locate your data directory on the data disk. 
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Ml) Marin 

Validating usar; sat 

Mapping datasets to files,.. 

XCLA0101T 

X0LA0102T 

X01A02O1T 

XCUW302T 

4 datasets — > 26 files 
Do you wish to edit the list of flies? IN] 

File verification and proprietary rights checking... 

Checking quotas... 

OKAY - Request size of 4332 bytes falls within aas available quota of 20971520 b 
ytesi 

Request stiwitted. Request id: aas 4862 ^ 

^Press return to continue... □ j 


Request ID 


Figure 3.10: Retrieval System Messages 

The list of files in your retrieval request is written to a file in 
your working directory. The root of the file name is the request 
identification string, and the file name extension is . req (for 
example: user 1234 . req). 

Press f Return! to exit from the retrieval process and to return to 
the StarView screen from which you initiated the retrieval request. 

Checking Request Status 

You can check the status of your retrieval request, to do this: 

1. Click on the [Retrieval Status] button from within the 
|Retrieve| menu on most StarView search screens, or click on 
the |Commands| menu from the <Welcome> screen. 

2. You will be asked to enter your request ID (as displayed in the 
previous steps). Type the request ID. 

3. Press I Return! to continue with your StarView session. 
Figure 3.1 1 shows a sample retrieval status screen. 
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Status flag—" F" means 
request is in the queue 


“R” means request is complete 
files retrieved to disk 


A number means your data 
were written to tape 


P 


0 


xterm 


Enter request id or user id [slovens]: ees 

Status of the latest request sUwitted: (aas48G2> 


Status MBytes 

& 


Number _of _Fi las 


4.229940 


? : Files not wntlormed in the database. Error in file na 
E : Error while retrieving the files. Sorry. 

F : Files to be pro cesse d soon. 

N : Files not currently in the archive. 

P : Files under proprietary restriction. Try again later. 

R ; Files retrieved on staging disk, 
n : (where n = 1..9): Files already on eag tape nwber n. 

<1 row affected, return status = 0) 

l^ress return to continue... D 


i rr> 


Figure 3.11: Sample Retrieval Status Screen 


Exiting StarView 

You can now either continue working in StarView, or you can exit. You 
could also exit from the archive host system (stdatu) altogether and wait 
for the mail message that will tell you that the files have been retrieved and 
are ready for you. This message will go to the e-mail account that you 
identifie d when you registered for an archive account. 

Press fControH - TTI to exit StarView. A dialog box will appear asking you to 
confirm that you really want to exit. Click on [OK] to exit. 


Getting Your Data 

After your data have been retrieved from the archive, you will receive an 
e-mail notification telling you that your files have been retrieved to your 
directory on the data disk on stdatu (or stdata). The files retrieved from 
the HST archive are currently VMS format GEIS files (see page 15). 

There are three ways in which you may work with the HST data files: 

• Using STSDAS on a VMS machine: You can retrieve the files directly 
using FTP (as shown in Figure 3.14) to transfer them to your home 
computer. 

• Using STSDAS on a Unix machine: You can first convert the files to 
Unix format GEIS files using vax2sun (Figure 3.12), and then trans- 
fer the files to your home computer using FTP (Figure 3.14). 

• Using other software on any platform: You can use st wf it s to con- 
vert the files to FITS format (Figure 3.13), and then use FTP to transfer 
the FITS files to your local computer (Figure 3.14). If you are on 
STDATU, then you must first use vax2sun (Figure 3.12) and then use 
stwf its on the converted files. 
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T data 

% cd aas4862 

% dir ^ 

x00c0102t . cOh xOOcOl 02t . cOd 
x00c0102t . clh xOOcOl 02t . cld 
xOOcOl 02t . dOh xOOcOl 02t . dOd 
x00c0102t . shh x00c0102t . shd 
% files 

template: *.*h 
outfile: myfili s.lst 

% more myfile.lst 
xOOcOl 02t . cOh 
x00c0102t . clh 
xOOcOl 02t . dOh 
x00c0102t . shh \ 

% mkdir converted 
% vax2sun 

input: @myfile.lst 
output: converted 
% cd converted 
% dir 

xOOcOl 02t . cOh x00c0102t . cOd 
x00c0102t . clh x00c0102t . cld 
xOOcOl 02t . dOh xOOcOl 02t . dOd 
x00c0102t . shh xOOcOl 02t . shd 


Go to appropriate directory 

Look at directory contents 

— VMS format GEIS files 

Use files task to write list 
of all files matching template in 
directory to a file (myf ile .1st) 


Make subdirectory for 
converted files 
(On STDATA, use 

create/dir [.converted]) 

Convert files to Unix format and 
write to converted directory 
(On STDATA use 

output : [ . converted] ) 

Unix format GEIS files 



Figure 3.12: Converting File Formats Using vax2sun 


% dir 

x00c0102t .cOh x00c0102t.c0d 
x00c0102t .clh x00c0102t .cld 
x00c0102t.d0h x00c0102t .dOd 
x00c0102t . shh x00c0102t . shd 

% files ^ 

templates : * . *h 
outfile: myfile.lis 

% more myfile.lis 

x00c0102t . cOh 
x00c0102t .clh 
x00c0102t .dOh 
x00c0102t . shh 
% stwfits 

iraf_files: @myfiles.lis 
fits_file: fitsfile «« 
Format_file: M 
log file: i I 

% dir fitsfile* 

fitsfileOOl 

f itsf ile002 
f itsf ile003 
f it sf ile004 


Go to appropriate directory 
List files in directory 

Create a list file called myf ile . lis 
of all header files in directory 

List file contents 

Creates files named 

fitsfileOOl, fitsfile002, etc. 

No response needed 
FITS format files 


% data 

% cd aas4862 
% cd converted 


Figure 3.13: Writing FITS Files 
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Connect to archive host — ► 

Move to correct directory 

I 

Set transfer mode ► 

to binary 

Transfer flies ► 

Close connection ► 

You are now ready to begin analyzing your dataset. Remember, if you 
have any problems or questions, contact the archive hotseat at 
ar chive 0 st sci . edu, or phone (410) 338-4547. 


% ftp stdatu.stsci.edu 
Connected to stdatu.stsci.edu. 

220 stdatu.stsci.edu FTP server (Version 5.86) ready. 
Name (stdatu.stsci.edu): Type your username 
Password: Type your password 

cmessage of the day displayed here> 

ftp> cd stdatu/dmf_stage/aas4862 

250 CWD command successful. 

ftp> binary 

200 Type set to I . 

ftp> prompt 

Interactive mode off. 

f tp> mget x* . * 

200 PORT command successful. 

50 Opening BINARY mode data connection for xOlaOlOlt . cOd 
226 Transfer complete 


ftp> bye 
221 Goodbye. 


Figure 3.14: Retrieving Files Using FTP 


Tutorial: Retrieving Calibration Reference Files 

StarView provides calibration reference file screens for each instrument. 
These screens let you see which calibration files and tables were used to 
calibrate a given dataset by the PODPS pipeline and which files and tables are 
currently recommended. You can mark either the used or the recommended 
reference files and tables for retrieval and retrieve them through StarView. 


If you already know the name of the calibration reference file or table you 
wish to retrieve (e.g., if you have determined the file name from a listing on 
STEIS), then you can retrieve just that file by using the [Add dataset] func- 
tion on the retrieval screen. This is described on page 49. 


In this example, we use a StarView reference file screen to retrieve both 
the used and recommended calibration files for a 3C273 dataset. 

1. Start StarView as described in “StarView Tutorial” on page 26. This will 
bring up the <Welcome> screen (Figure 3.3). 
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2. Click the [Other Searches] button. 4 (We want to find the 
appropriate search screen for calibration reference files.) The 
<Other Searches> screen will be displayed (Figure 3.15), with 
the cursor highlighting “Quick Search”. 


r 0 

< Other Searches > 

‘r 

File Coaaands Options 

Coaaents 

Help 

i - 1 


Use <TAB> key or Mouse 
[Quick Search 


General Search 


[Proposals 


[Proposal Abstracts 


[Fixed Targets Search 


[Solar Systea Targets 


[Exposure Search 


[Duplication Check 


Data Files: 
[Dataset Naae| 
I Files I 


to Hove cursor. Use House to select search. 

| FGS/AstroHetry | HSP: | Instruaent 


F0C: IlnstruMent | 
[calibration] 


F0S: [instruaent | 
[calibration] 
[Flat Field | 
flnv. Sens. | 


[calibration! 

WFPC: 1 Instruaent | 
[calibration! * 
[Flat Field"! 
[pTf Files | 
fbelta FlaTl 


WFPC-2: [instruaent 


GHRS ' linstruaent [ 
[cal 1b ration] 


[calibration! 


Flat Field 


PSF Files 


[Delta Flat 


[strategy] [Exit Screen *z| 


[MESSAGE: Enter search constraints, press [ Begin Search ] when ready, j 


Button for 
Choosing WF/PC 
Calibration 
Reference Files 
Screen 


Figure 3.15: Other Searches Screen 

3. Select the <WFPC Reference Files> screen because we will 
retrieve calibration files for a WF/PC observation. The < WFPC 
Reference Files - Search Specification> screen will be dis- 
played. 

4. Specify criteria. We want to specify a particular dataset, so 
press the arrow keys until the cursor moves to the “Rootname” 
field, and then type the dataset name for the observation whose 
calibration files will be retrieved. For example, enter 
W19C0101T (see Figure 3.16). 


4. Users of the terminal version can use the accelerator E+ 1 . 
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0 < WFPC Reference Flies - Search Specification > 

File Seiches Constraint View Retrieve Custom re £>tlons Comments Help 


pi : 

Proposal ID 


Target : 



Rootrvame: 

J£9C0101T 1 Filter!: [ | Camera: | ~"j 

Mode: r_J 


Flltar2: | | Clock: | | Shutter: Q] 

Orien.fi : 

| | Orien.B: | j Ohien.C: | j 

Orten.D: 


USED RECI»t€NDEL PERFORMED 

(T-to-D Correction: 

Bias Correction: 

Dark Current Correction: 

Flat Field Correction: 

Static Pixel Mask; 

Preflash Correction; 

Purge Reference File: 

Engineering File: 

Photometry Cal, Table: 



Enter search constraints in one. or more of the fields above. 
Use TAB key or mouse to move between fields. 



| Begin Search] Icioor Constraints! 

[vieia^Resultsj jExlt Screen *z| |Stret.gg 1 

hCSSflGE: Enter search constraints, press ( Begin Search ] .hen ree4j. 


Figure 3.16: WFPC Reference Files - Search Specification Screen 
(Constrained) 

5. Click on the [Begin Search] button to submit your catalog search request. 
The <WFPC Reference Files - Search Results> screen will be displayed 
for the observation that you specified (Figure 3.17). 
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r Q 


< WFPC Reference Files - Search Results > 


File Searches Constraint View Retrieve Customize Options Coswe n tt 


Help 


PI 

Target 

Rootnane 


UESTPHAL 


Proposal ID 


eeh 


3C2 73 -OFFSET 


H19C0101T 


Fllterl 

Fllter2: 


: \n] Canera: ED Node: r*n 
□ Clock: EH shut*--* [T] 


-15.526 

Qrten.B: 

74.383d 

Orian.C: 

165.483 

Ohlen.D: 

-105.02 


P-to-D Correction: 
Bias Correction: 
Dark Current Correction: 
Flat Field Correction: 
Static Pixel Mask; 
Preflash Correction: 
Purge Reference File: 
Engineering File: 
Photonetrg Cal. Table: 


USED 


RECtWCHDED 


PERFORMED 



(step Forward | 

(Step Back| (Mark USED Files for One Dateset | 



(Scan Forward"! (Scan Back| {hark RECOMMEHDEB for One Dataset | 


(Edit Search Constraints | [Mark USED Files for fill Datasets | 


1 ■■■ ■■■■ 1 


■Bassasaaitsga 


{Retrieve Data| {Strategy | 

} Unnark All Flies for Ohe Dataset | 


Record 1 of 1 (in progress) jUhnark All Files for All Datesats| 

[fxlt Screen 

Use i*>/do*n arrow kegs in data area to scroll full list of calibration files. 
.MESSAGE: More r e co rd s available. Use record controls to view search results 


Figure 3.17: WFPC Reference Files - Search Results Screen 

(With Results Displayed) 

6. Click [Mark USED Files for One Dataset] to marie for 
retrieval those calibration files actually used to calibrate the 
dataset. If the files listed in the RECOMMENDED column dif- 
fer from those in the USED column, then you can click on 
[Mark RECOMMENDED for One Dataset] to retrieve the 
calibration files that are now recommended for calibrating the 
data. 

7. Click the [Retrieve Data] button to begin the retrieval process 
for the marked reference files. Continue with the data retrieval 
procedures as outlined in “Retrieving Datasets From the 
Archive” on page 37. 
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The defaults on the <Retrieval Request-File Option> screen, i.e., calibrated, 
will return the correct files for the specified calibration reference files and 
tables. You do not need to specify an extension. 


Retrieving a File By Name 

If you know the name of a file or dataset that you wish to retrieve from the 
archives, you can retrieve it directly using the [Add Datasets by Name] 
button from the <Archive Retrieval screen. To get to this screen from the 
<Welcome> screen, pull down the |Commands| menu in the menu bar (see 
Figure 3.1) and choose the “Retrieve Marked Datasets” option. This will 
place you in the <Archive Retrieval screen. 

Click on the [Add Datasets by Name] button from the <Archive 
Retrieval screen (or use [Add Datasets from File] if you have a list of 
dataset names). Enter the rootname (no extension ) of the calibration reference 
file or science file you wish to retrieve. When you have added all the 
rootnames for the files you wish to retrieve, click on [Submit Request] and 
proceed with the retrieval process as described on page 37. 
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Duplication 

Checking 


The simplest and most robust way to determine whether the observations 
you wish to propose for Cycle 5 conflict with previously accepted GO or GTO 
observing programs is to use the <Duplication Check> screen in StarView. 
This screen can be used to perform target name based searches or RA and Dec 
based searches of all planned or completed HST observations. Archival 
proposers will also find the <Duplication Check> screen useful for preparing 
their archival proposals. Preview of public data is available from this screen 
from xstarview. 

In this chapter, we provide an example that shows how to use StarView to 
perform duplication checking. We use the <Duplication Check> screen to 
search for planned or executed spectroscopic observations of NGC1275. We 
then use the <Proposal Abstracts> screen to understand the scientific aims of 
the matching observations which are found. 

1. Start StarView as described in the “StarView Tutorial” on page 26, i.e., 

either telnet stdatu.stsci.edu or telnet 

stdata.stsci.edu, login with username “archive” and password 
“guest” — or use your registered username and password, and type 
xstarview or starview from the command line. 

This will bring up the <Welcome> screen (Figure 3.1 on page 28). 

2. Click the [Duplication Check] button. 1 The <Duplication Check 
Search> screen will appear. 

3. Specify the search criteria. In this case we wish to search for all spectro- 
scopic observations of NGC1275. Qualify on instrument as fos,hrs 
since these are the two spectroscopic instruments (the comma separating 
the instruments is interpreted as an “or” by StarView, see also page 33). 

Use the [SIMBAD Coordinates] button to determine the coordinates of 
NGC1275. When the SIMBAD window appears type “NGC1275” as 
shown in Figure 4.1. SIMBAD connects and returns the coordinates, fill- 

1. Users of the terminal version can use the accelerator E+2. 
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ing the results into the RA and Dec fields on the duplication 
Check Search> screen along with a default circular search 
radius of 10'. Figure 4.2 shows the screen as it looks now. 



J4ESSAGE: Enter search constraints, press t Begin Search 3 irfien ready. 

Figure 4.1 : SIMBAD Coordinates Screen 
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Figure 4.2: Duplication Check Screen with SIMBAD Coordinates 

4. Initiate the search. Click on the [Begin Search] button to begin the 
search; a match is found and the screen switches to the <Duplication 
Check Results> screen (Figure 4.3). Step through the matching records 
one at a time or view the matching records a page at a time by switching 
to table row format (click the [View Results as Table] button). 
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( 3 < Duplication Check Search Results > 


File Searches Constraint View Retrieve Customize Options Consents 


Proposal ID: | 3550 [ 
Proposal Cycle: | | 

Conflict type: | carryover 
Target na«e: NCC1275 

32000 RA: I 3h Ida 48. Id I 


PI: JOHNSTONE 


«■ □ 


Exposure status: planned - cycle 


Dec: +41d 30s 42. 


Instruaent: | FOS | 
Corrected Optics: | T | 
Filters/gratings: |ci30H 

Apertures: 0.25X2.0 

Exposure length: I 9100.000 


Configuration: | FOS/Bl 
Optical node: I ACCUM 


Dataset nase: 


Release date: 


Quality 1: 
Quality 2: 


Step Forward! (Step Back! [Mark Dataset} [Retrieve Marked Data 


Scan Forward Scan Back! lOnaark Data I I Write Result to File 


Edit Search Constraints 


Hark All 


View Result as Table 


Record 1 


(In progress) I Unnark All 
[Exit Screen A Z 


Strategyl iPrevlew 


MESSAGE: More records available. Use record controls to view search results 


Figure 4.3: Duplication Check Results Screen 


Remember, the duplication Check> screen displays both 
completed and pending observations. Inspect the “exposure 
status” held displayed on the screen to discern the status of 
each matching observation. Two special types of planned 
observations are identified via the the “conflict type” held; 
these are GTO-Reserved Targets for Cycle 5 or Carryover Pro- 
posals from Cycles 0-3. All other observations are normal 
Cycle 1-4 observations. The “optics corrected?” held will be 
true for WFPC2 observations and for FOC, FOS, and GHRS 
observations taken after COSTAR was in place, indicating that 
these observations are corrected for the aberration of the pri- 
mary HST mirror. 
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Click on the [Strategy] button for more information about what consti- 
tutes a conflict , including the formal duplication policy. 

Completed exposures which are public (with release dates less than 
today’s date) can be previewed by clicking on the [Preview] button. 

5. In this case, we find a matching observation (under proposal ID 3550) 
which may duplicate our planned observations. We can further investigate 
the potential of this observation as a conflict by examining the abstract for 
this proposal using the <Abstracts> screen. 

To get to the <Abstract> screen, pull down the |Searches| menu from the 
menu bar on the top of the screen and choose “Proposal Abstract” (or you 
can return to the <Welcome> screen and choose [Other Searches], see 
also Figure 3. 15 on page 46. 

When the <Proposal Abstract Search> screen appears, enter the proposal 
ID and click on [Begin Search], The abstract is then displayed (see 
Figure 4.4). 



Figure 4.4: Displaying an Abstract 

Remember, the duplication Check> and <Proposal Abstract> screens are 
designed only to help you to identify potential conflicts; you will have to 
decide whether the apparent conflicts are real. More information about what 
constitutes a conflict can be obtained by clicking the [Strategy] button on the 
duplication Check> screen. 
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The current duplication Check> screen requires you to check tar- 
gets one at a time. We are currently developing the ability to simul- 
taneously cross-correlate a list of target RA and Dec positions 
against the catalog. When available (most likely by mid-June), you 
will be able to select the [Cross Correlation] button from the com- 
mand area of the duplication Check> screen. More information 
about this capability will be provided as part of the Strategy for the 
duplication Check> screen when the feature is enabled. 


Forms 


In This Appendix... 

HST Archive Account Registration / 58 
HST Archival Data Request/ 59 
HST Archival Research Visit Request/ 61 


T„, appendix provides forms for requesting accounts, data tapes 
of files from the archive, or visits to the Space Telescope Science 
Insitute (STScI). PostScript versions of these forms are also available 
in the forms subdirectory of the documents directory on the archive 
host workstations. 

Please photocopy these forms and use them as needed. 
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System Preference 

Which host system do you prefer? (Choose one) 

□ VMS (stdata . stsci . adu) □ Unix (stdatu . stsci . edu) 

Users of the stdata and stdatu accounts are expected to maintain their accounts in a secure manner. 
This includes choosing reasonable (non-simple) passwords, changing passwords often, and notifying 
archive0stsci.edu immediately if there is any evidence of break-in. Users should not share 
accounts. Note that there is a quota on the total amount of archive data that an individual can retrieve and 
this limit is based on the user name. Archive accounts are being set up with limited access to Institute 
software and are not for general purpose computing. Use of these accounts will be monitored. 

□ Check here to certify that you have read the above 
security statement and agree to abide by it 


Special Requests or Comments 


Mail Form To: 


HST Archive 

Data Systems Operations Branch 
Space Telescope Science Institute 
3700 San Martin Drive 
Baltimore, Maryland 21218 

FAX: (410) 338-5090 


STSc[ Use Only 

Date Received: 

I Date Processed: 






HST Archival Data Request, 

Contact Information 

Full Name 

E-mail Address 

Postal Address (for Shipping Data) 


Country 

Phone FAX 

Datasets Requested 

List rootnames of all requested datasets below. You will receive all of the files associated with each dataset 
unless you request specific files. 


Tape Format 

Data will be supplied on magnetic tape in FITS format. Please select FITS file format and media from 
the following options (see notes on back of this page). 


FITS Files 


Media 




Use ST default FITS 

• IEEE floating point 

• All groups in one file 

• Blocking factor 10 

Special requirements 

If you cannot use the HST default FITS format, you 
may specify your special needs here. These may 
consist of the following: 

• Scaled integer (inappropriate for some data) 

• Blocking factor x (where x is less than 10) 

• Groups split into separate FITS files 

HST Data Archive personnel will contact Pis 
with special needs to clarify the need. 


□ 

□ 

□ 


8mm Exabyte cassette 
6250 bpi 9-track 2400' 
1600 bpi 9-track 2400' 


Continued, 
on other side 
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Return Form to: 


STScI Use Only 

HST Archive 

FAX: 

Date Received 

Data Systems Operations Branch 
Space Telescope Science Institute 

(410) 338-5090 

E-mail: 

Date processed 

3700 San Martin Drive 

archive@stsci.edu 

Baltimore, MD 21218 



Notes on FITS Format and HST Defaults 

HST data are stored as real numbers and may suffer loss of precision 
when written in formats other than the HST default of IEEE FITS for- 
mat (for example, when converting to scaled integer without writing 
groups as separate FITS files). HSP data and FOS polarimetry data 
require the double precision of the HST default In addition, small inac- 
curacies can be introduced in the HRS wavelength scale and in the zero 
values in FOS spectra when scaled integers are used. For these reasons, 
we ask you to use the HST default if at all possible. 

Although all astronomers are urged to use the HST default, we will con- 
tinue to honor some special formats, for the time being. The special for- 
mats are: “Scaled integer” instead of IEEE floating point; “Groups split 
into separate files” instead of using an extra dimension in the same file; 
and “Blocking factor 1 ’ equal to a number less than 10. The HST data 
archive personnel will contact anyone who requests a special format 

The following media are available: 

* 9-track tape (1600 and 6250 bpi) 

• 8mm Exabyte cartridge 

Only astronomers with very old 9-track tape drives should consider a 
blocking factor of 1 (the default is 10) because of the small buffers on 
early tape drives. All modem tape drives and all Exabyte tape drives are 
capable of handling the default blocking factor, which uses tape more 
efficiently. 
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HST Archival Research Visit Request 


Contact Info... 

Full Name: 
Institution: 

Postal Address: 




Phone: 
E-mail Address: 


FAX Number: 


i- A* :• : : : : : : *:* : -i* :* z : i A ^ : *A : x V : : : ?i : : : ^ : : : : : :< :*x*: : : : : : x*x¥i-> >: : c< i*^ y ^ iix i-: 

Funding... 


Is your archival research a funded HST Archival Research Proposal? 

□ Yes, Proposal ID: □ No 

Unfunded researchers should attach a page describing, in detail, 
the scientific objectives of their archival research program. 


About Your Visit. 




What part of your archival research program will be accomplished 
during your visit? (Please be specific) 


Duration of Visit: 

Preferred Dates for Visit: 

Datasets to be Used (by name, or description): 


ft ft-- ; £ -ft-:ftftftftftft£ftft£.£^^ 


mmmmm 




Mail Form To: 


HST Archive 

Data Systems Operations Branch 
Space Telescope Science Institute 
3700 San Martin Drive 
Baltimore, Maryland 21218 


STScI Use Only 

Date Received: _ 
Date Processed: _ 


FAX: (410) 338-5090 
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